Temenos Digital
R24 AMR | Min(s) read

Install Quantum Fabric

The first step in the Temenos Digital set up involves the installation of the Quantum Fabric software. This is the base on which all server-side components reside. To install Quantum Fabric, follow these guidelines:

  • Quantum Fabric can be set up on the cloud or on-premise. Choose any of the following installation paths based on your requirement:
    • Cloud: Make sure that Quantum Fabric 202404.0.0 is available on Temenos Cloud. If you have not created a cloud instance already, refer to Quantum Fabric User Guide for more information. You should also have a Quantum Fabric account with valid credentials. Refer to Creating Quantum Fabric Account for more information.
    • On-premise: The equivalent version is closest installer version to 202404.0.0. To set up and configure the Quantum Fabric on-premise environment, refer to Quantum Fabric User Guide.
  • In Quantum Fabric, add the following Tomcat argument:
    -DKONY_SERVER_CUSTOM_VERB_RESPONSE_FORMAT_ENABLED=false
  • Download software: Request for download access. Contact your Temenos representative for more information.
  • Make sure that you have the database installed in the system.
  • Refer to the list of licensed software being used including third-party licenses.
  • Ensure that you have Tomcat 9.0.33 (use the default Tomcat that comes along with Quantum Fabric installation).

Install Quantum Fabric on Virtual Machine

Applicable for Temenos Digital manual installation option.

Prerequisites

  • Make sure DNS entries and certificate is in .jks format before starting Fabric installation in case of https Fabric instance is used.
  • MySQL version is greater than or equal to 5.7.33.
  • SSL certificate is required for https Fabric instance; make sure the certificate is compatible with the domain name.

Installation Requirements

  1. Make sure to download supported Quantum Fabric Instance based on Temenos Digital product version you are installing. See Download Software Assets for more information.
  2. Download the prescribed Quantum Fabric.
  3. Place the SSL certificate at a safe location on the VM.
  4. Points to be noted before installation:
    • MySQL should be running on an enabled port.
    • MySQL should have default time zone variable - add

      default_time_zone='+00:00' to my.ini file.
    • SSL certificate should be in . jks format.

Installation

Follow this link for complete installation.

Configure Tomcat

  1. Stop the Tomcat service by navigating to Fabric installation folder/tomcat/bin - start shutdown.bat file.
  2. Add Tomcat argument to catalina.bat file in JAVA-OPTS.

    -DKONY_SERVER_CUSTOM_VERB_RESPONSE_FORMAT_ENABLED=false

  3. Start the Tomcat server by navigating to Fabric installation folder/tomcat/bin - start startup.bat file.

Create Environment on Fabric

  1. Open Quantum Fabric.
  2. Click the Environment tab on the left pane.
  3. Click add environment.
  4. Give an appropriate name and clear the Allow manual publish only check box.
  5. Give domain name which is given as part of Fabric installation as the URL for server (domain name/admin) and Engagement tab (domain name/kpns).
  6. Test the connection.

Configuring Custom Response Headers

This section describes how to configure response headers to be sent to the client app on every request.

  1. Open Fabric admin console.
  2. Navigate to Settings > Runtime Configuration tab.
  3. Under property Name, open Web Apps Configuration.
  4. Enter the Custom Response Headers values as required that are to be returned in every request.
  5. Sample configuration is given below:
    [{'name': 'X-Content-Type-Options', 'value': 'nosniff'} , {'name': 'X-XSS-Protection', 'value': ' 1; mode=block'} , {'name': Strict-Transport-Security, 'value': 'max-age=86400; includeSubDomains'}, {'name': X-Permitted-Cross-Domain-Policies, 'value': 'master-only'}, {'name': 'Expires', 'value': '0'}, {'name': 'Cache-Control', 'value': 'private, no-cache, no-store, max-age=0, no-transform'}, {'name': 'Pragma', 'value': 'no-cache'}, {'name': 'X-Frame-Options', 'value': 'SAMEORIGIN'}, {'name': 'Access-Control-Allow-Methods', 'value': 'GET, POST, PUT, DELETE'}]
  6. Restart the server to reflect the changes.

Troubleshooting

If connectivity to MySQL server fails during Fabric Installation, make sure to check the ipaddress, port , username, and password are provided correctly. If the issue still exists, then abort the installation which will generate a log file in desktop. Check if you are seeing the following exception:
Caused by: com.mysql.cj.exceptions.InvalidConnectionAttributeException: The server time zone value 'Coordinated Universal Time' is unrecognized or represents more than one time zone. You must configure either the server or JDBC driver (via the serverTimezone configuration property) to use a more specifc time zone value if you want to utilize time zone support.

Add the default time zone variable to the my.ini file located at ProgramData\MySQL\MySQL Server 5.7.

If you are unable to restart Tomcat instance after adding the following argument in catalina.bat file, then there is a chance that JAVA installed as part of Fabric could be corrected.
-DKONY_SERVER_CUSTOM_VERB_RESPONSE_FORMAT_ENABLED=false

Run command "java -version" from FabricInstallationFolder\jre\bin folder which will generate a log file with name, hs_err_pidxxx.log.

If the following issue is seen, then reinstall Fabric.

A fatal error has been detected by the Java Runtime Environment:

EXCEPTION_ACCESS_VIOLATION (0xc0000005) at pc=0x00007ffbe6354d99, pid=11944, tid=7564

During Fabric Installation, if the installation dialog is not accepting the SSL certificate, then check the provided certificate extension. It should be with .jks extension and in lower case.

Post Fabric installation, if you are not able to access the https://domainname/mfconsole URL, then make sure the https port is opened in the VM instance.

This issue is applicable to on-premise Fabric setup. While creating the Fabric environment, the runtime components have to be configures like server, engagement, and sync. Under the server section the URL should have the protocol, hostname, and port. But users may additionally provide the "/admin" context as shown in the image. The service URLs in the service document will have the "/admin" context but these urls won't exist in server in realtime. Hence, 404 error occurs.

Solution:

  1. Login to your Fabric associated database and verify.
  2. Under the <prefix>mfaccountsdb<suffix>.features table, check for the row where type = "server". In this row, verify the value for "service_url".
  3. If the value is "<host>:<port>/admin", then update the value to "<host>:<port>/services". Once the changes are done and committed in the database, publish the Fabric app and check whether the app service document is updated with "/services". If it is successfully updated, do the following:
    1. Associate the Visualizer app to Fabric app once again and do the Visualizer build.
    2. If the build is successful, then publish the Fabric app again.
    3. If the publish is successful, clear the browser cache and hit the URL. The issue will not occur.
  4. The reason for building the app once again is to download the updated service document. Therefore, this step is mandatory.

 

Copyright © 2020- Temenos Headquarters SA

Contact Us

knowledge@temenos.com

Published on :
Thursday, May 30, 2024 12:28:21 PM IST